home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / applications / dtp / labslct442.lha / Labsel.doc < prev    next >
Encoding:
Text File  |  1994-10-28  |  9.0 KB  |  218 lines
  1.  
  2. LabSelect version 4.42                       WorkBench 2+ ONLY
  3. ~~~~~~~~~~~~~~~~~~~~~~~                     ===================
  4.  
  5. ** NB: This program requires req.library to be in your libs: directory.
  6.  
  7. The program can be run from a Workbench icon, or from the CLI: and it
  8. is Public Domain.
  9.  
  10.   The objective of this program is to print small batches of labels
  11. for a single addressee - something I can't find in any label-printing
  12. utility I've so far seen.  If you want to print runs of single labels
  13. for a number of separate addressees, there's 'EnveloPrint' available
  14. in PD.  Or you can use the Mailing option which is in several word
  15. processors and database systems.
  16.  
  17.   Right:- that's what it's for.  And I wrote it for myself because it
  18. does exactly what I want.  So don't come wingeing to me that "it
  19. doesn't do...." since it wasn't designed to do that!
  20.  
  21.   Apart from that, and taking it as a purpose-written utility, I now 
  22. publish LabSelect in the Public Domain on an "as is" basis. 
  23.  
  24.   Many thanks to Bil Irving and Jim Perry for advice on the screen
  25. display and the Help feature, to Steve Parkinson for help in tracking
  26. down a few coding bugs, and Anthony Keeley for winding me up
  27. something rotten (and confirming the advice Bil gave me).
  28.  
  29.                 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  30.  
  31. Instructions
  32. =============
  33.   Type your addresses with any editor, each name/address as a
  34. separate file, which I suggest you save with extension ".lab".  Some
  35. example files are supplied with this program.  There's no need to
  36. allow margins at top and left of the text, as these can be adjusted
  37. at run time.
  38.  
  39.   If you use a word-processor, make sure that you save the file in
  40. ASCII format.  This usually means you must select the "Save as" menu
  41. option, where you can specify the format as ASCII.  In Wordworth
  42. there's a file requester & a "Format" button in the Save window.
  43. Click on "Format, and in the format window click on ASCII.  In some
  44. processors you have to ask for "Save as text", "Print to file", or
  45. "Print to disk".
  46.  
  47.   Put these files in any directory, on any disk.  The S:  directory
  48. is a logical place unless you have other ideas.  Give the files a
  49. .lab extension and you can arrange for your file requester only to
  50. show those files.
  51.  
  52.   Label stock should be 'one abreast' and preferably tractor fed.
  53.  
  54.  
  55. LQ printing ("Letter Quality")
  56. -------------------------------------
  57.   LQ is provided for use with printers that do not have their own
  58. built-in fonts and are either set by the system Printer Preferences
  59. or by internal switches.  If your printer has selectable fonts, then
  60. the LQ option should NOT be used as it will cause your printer to
  61. revert to system Printer Preferences (in LQ mode).
  62.  
  63.   If Letter Quality is already set in Preferences, then turning it off
  64. by selecting "Draft Quality" in this program will make no difference.
  65. The program only changes the setting if LQ is requested, and then
  66. restores the previous setting as soon as printing is terminated.
  67.  
  68. The File Requester
  69. ------------------
  70.   This is initally set to show all files in the S:  directory
  71. (drawer) only.  If you enter a different directory, or enter a
  72. 'template' in the SHOW box (bottom right), you can save these
  73. preferences to the Config file for future use.  e.g.  You want only
  74. to show files with extension .lab so you would enter *.lab in the
  75. SHOW box.  (* in this context means "any name", equivalent to the DOS
  76. use of #?)
  77.   Or if you want to show only files with .label extension in a drawer
  78. called "Addresses", you would enter "Addresses" (no quotes) in the
  79. Drawer box, and *.label in the Show box.
  80.  
  81. Configuration file
  82. ------------------
  83.   Once you have set your all your preferred options to your needs,
  84. you can save these values to a "config" file for use each time you do
  85. another run ......
  86.  
  87.   Select "Save config" from the pulldown menu (top left of title
  88. bar), and your settings will be written to "Labsel.config" in the S:
  89. directory.  This file, if it exists, will be read in and used each
  90. time you start up.
  91.  
  92.  
  93. Command arguments
  94. ------------------
  95.   This is for users who just love entering commands.  In fact they
  96. are totally unnecessary, but here goes.....
  97.  
  98.   You can over-ride the configuration file, or store your settings if
  99. the config file doesn't exist, by using "command line arguments" when
  100. you start the program.  Note that only those arguments entered this
  101. way will affect the config held on file.  Any others on that file
  102. will be used as found.
  103.  
  104.   If you run the program from the CLI you can enter up to 6 arguments:-
  105.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  106.   -p<path> to set the default data directory ('drawer')  e.g.  -pSys:labdata
  107.  
  108.   -m<margin> to set the printing offset        e.g.  -m4
  109.  
  110.   -l<label spacing> to set the spacing, usually 9 or 12 lines. eg -l8
  111.  
  112.   -c<copies> to set the number of copies of each label  e.g. -s6
  113.  
  114.   -s0  will turn off the 'custom screen'. Windows appear on Workbench screen
  115.   -s1  will turn on the custom screen. Windows will appear on this screen.
  116.   -s<screen name> will attempt to use the named Public screen
  117.        e.g. "-sMyPublicScreen". If this fails, the WB screen is used.
  118.  
  119.   -n0  will turn off LQ:  "Letter Quality" is the default setting.
  120.   -n1  will restore  LQ:  enabling you to save a new config using LQ.
  121.    (Note that this setting can also be changed by Menu at runtime)
  122.  
  123.  These may be entered in any sequence.  e.g.
  124.               labselect -l0 -m4 -n0 -psys:labels -s
  125.  
  126.  and if you forget this lot, use:-  labselect ?   for the list of arguments.
  127.  
  128.  These settings can be saved to the config file for future use without again
  129. entering them. (See next section: Menu)
  130.  
  131. The Menu
  132. ---------
  133.   A pulldown menu is provided with 5 options:
  134.  
  135.   1. LOAD CONFIG  Loads the setting you stored on a config file. This has
  136.      no effect until you have already Saved such a file.
  137.  
  138.   2. SAVE CONFIG  saves all your current settings to S:LabSel.config
  139.      This file is automatically loaded when you next run LabSelect.
  140.  
  141.   3. LETTER QUALITY sets the LQ flag. Use this option ONLY if your
  142.      printer is set for draft mode otherwise, and NOT if you have
  143.      already selected a special font on the printer. Using this flag
  144.      will cause the system Printer Preferences to be used plus the
  145.      LQ option for the duration of label-printing (only).
  146.  
  147.   4. LQ OFF  unsets the LQ flag. The print quality now depends on your
  148.      Amiga Print Preferences and/or your printer settings. This menu
  149.      option does not actually set "draft" in your preferences - it merely
  150.      refrains from setting LQ internally at label-print time.
  151.  
  152.   5. QUIT yet another way to close down the program. You're spoiled for
  153.      choice!
  154.  
  155.  
  156. Changes in Version 2
  157. ----------------------
  158. Revision 25:
  159.   Public screen options put in.  Memory leak of 299 bytes after each
  160. run (in version 1) has been found & corrected.
  161.  
  162. Revision 26:
  163.   Changes to the LQ option ('Letter Quality') which did not work if
  164. the program was run from Workbench (icon).  LQ is now the default
  165. setting, and can be over-ridden/restored by command line arguments
  166. (see below), or from the menu (see below).  Current setting is
  167. included when you Save to the Config file (by menu).  If LQ is used,
  168. the printer preference setting is changed in memory, and restored to
  169. what it was before when a print batch has been done.
  170.  
  171. Revision 27:
  172.   Something went wrong with the 'Use default public screen' option -s0
  173. and this revision would guru if that argument was entered. Not really
  174. sure what happened - presumably tinkering with coding without checking
  175. it afterwards (hides head in shame). However, some more tinkering with
  176. a few nested IF clauses cleared the problem. At the same time some more
  177. folly protection was put in, and if a 'named public screen' is not
  178. found, the program reverts to using the Workbench screen without complaint
  179. or crashing!
  180.  
  181. Changes in Version 3
  182. ----------------------
  183. Revision 28:
  184.   The user can now enter a template in the 'Show' box of the file
  185. requester.  This will be saved to the config file for future use.
  186.  
  187. Changes in Version 4
  188. ----------------------
  189. Revision 29:
  190.   Changes to documentation (this file) to explain use of "Letter Quality".
  191.   Number of copies "Other" string gadget contents now changed to reflect
  192. user's most recent choice when selected on a button.
  193.   If "VIEW" data is selected, then data will continue to be shown in the
  194. viewing window after change of file, or on closing the Help window.
  195.   String gadgets for "Other" now respond to a mouse-click in help mode.
  196.  
  197. Revisions 30-39: never existed
  198.  
  199. Revision 40:
  200.   Now copes with situation where there is no S: directory. This
  201. is an unusual situation - to say the least - but it creates problems.
  202. Thanks to Steve Parkinson for causing me much aggravation!
  203.  
  204. Revision 41:
  205.   Cosmetic changes only. 
  206.  
  207. Revision 42:
  208.   Handling of the "Other (enter)" gadgets has been improved. You no
  209. longer get a "Silly!" message when you click on one of these gadgets,
  210. unless you actually enter a silly value (like zero) for copies or
  211. label spacing.
  212.   The initial message, on startup, shows whether Letter Quality is
  213. selected or not (from your config file).
  214.  
  215.                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  216.  
  217.                                                   Gnome    28.10.94
  218.